home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / xmobuf64.doc < prev    next >
Encoding:
Text File  |  1985-06-03  |  7.1 KB  |  111 lines
  1. XMOBUF
  2.                          An Xmodem Protocol Terminal
  3.                              For the Commodore 64
  4. First a few Thank-yous for people who made this program possible.  We all owe
  5. alot to Ward Christensen who came up with the protocol in the first place.  
  6. Karl Schmidt deserves much credit for trying to code it in the first place.  I
  7. want to thank my good friend Robert Shaw, who endured many agonizing hours
  8. while we worked out the 64 to 64 mode.  Dick Press provided the non CBM BBS
  9. where most of the alfa testing was done against TBBS software running on a
  10. TRS-80.  Frank  Prindle provided some operating system hints that make the
  11. protocol run accurately and some hints on approaches to use in constructing the
  12. buffer.  Deb! Christensen for her SEQ reader, and her enthusiastic
  13. encouragement to go on and finish it.  Steve Taylor for some pointers on what
  14. the compiler might or might not like.  Bill Eisenhower for helping Beta test
  15. it.  And everyone who provided feedback on stuff I missed in alfa/beta testing
  16. it, including Rick Sterling, Deepak Midha, Preston Tuchman, and Jim Nicholson.
  17.                             GENERAL CONSIDERATIONS
  18. This program has been designed with the casual user in mind.  The entry screen
  19. gives the user a choice of accepting the default colors (black with white
  20. characters) or changing them.  If you wish to use b&w, then any key will bring
  21. up the next prompt.  <N> brings up a prompt to enter the CBM colors of your
  22. choice for character, border, and background color.
  23.    Black ..... 0    Orange .... 8
  24.    White ..... 1    Brown ..... 9
  25.    Red ....... 2    Lt. Red ...10
  26.    Cyan ...... 3    Lt. Gray ..11
  27.    Purple .... 4    Med Gray ..12
  28.    Green ..... 5    Lt. Green .13
  29.    Blue ...... 6    Lt. Blue ..14
  30.    Yellow .... 7    Dark Gray .15
  31. The next prompt gives you a choice of modes - <1> Bulletin Board or <2> 64 to
  32. 64.  For most applications, the bulletin board mode is fine, and sets the
  33. system for full duplex, no parity.  The 64 to 64 mode is designed specifically
  34. for use between C64s.  It sets software half duplex so that it will work with
  35. any modem configuration.  You do not need to set the modem for half duplex as
  36. well.
  37. The second screen prompts for a baud rate choice to be made.  <3> for 300 and
  38. <1> for 1200 so the choice becomes automatic with use.  If you are using a CBM
  39. 1650 modem, your only choice is 300 baud.  For modems connected via an RS232
  40. adapter, XMOBUF will run smoothly at 1200 baud.  If your modem understands
  41. hayes style modem commands, the terminal program will automatically reset the
  42. modem to your choice of speeds.
  43. Following a short delay while the translation tables are set up and program
  44. variables are defined, you will be presented the main terminal screen, and you
  45. are ready to communicate.  Two menus are available from this screen.  Pressing
  46. Function Key 1 <F1> will bring up the main menu.  Please examine it before your
  47. first use of the program.  Most functions are self explanatory.  The last
  48. sentence on the bottom of the menu changes in 64 to 64 mode to remind you that
  49. the sending side goes to Upload before the receiving side goes to Download.
  50. Pressing <F3> from the terminal mode will bring up the Buffer control menu.  It
  51. is also listed on the main menu for convenience.
  52.                                 BUFFER CONTROL
  53. XMOBUF uses xon-xof flow control to keep up at high speed, and will work well
  54. with any host that respects xon-xof.  If you are having problems with
  55. information being garbled, it is possible that the host is not observing the
  56. xon-xof convention.  This should not pose a problem at 300 baud as compiling
  57. gives the program sufficient speed to keep up.  Provision has been made to
  58. redisplay the buffer, and there are several ways to see what is in the buffer.
  59. You can print the buffer to the modem after your session, or you can save it to
  60. disk and then read it using the built-in SEQuential file reader.
  61.                                 64 to 64 mode
  62. In 64 to 64 mode, the terminal sets half duplex, and provides the echo of what
  63. you type.  There are cues sent as each 64 changes modes to keep the other
  64. person posted.  Each of these cues is preceeded by a pair of semicolons (;;)
  65. and each is self explanatory.  As the other operator checks disk directories or
  66. prepares to send a file, you are kept informed.  The 64 to 64 mode should not
  67. be used with any host that provides echoing from the host as you will see
  68. double characters from everything you type.
  69.                     A Little Bit About .BIN and .IMG Files
  70. When you upload a program file to any host, the file you are sending with
  71. XMODEM is a Binary file.  Compuserve uses the image designator to denote a file
  72. uploaded with Vidtex.  If you download an image file from Compuserve using
  73. XMODEM, there will be 9 extra characters sent as a header.  XMOBUF strips those
  74. first 9 characters and ignores them, permitting transfer of .IMG files to your
  75. computer.  It is up to you to ensure that the file you are downloading will
  76. work on your computer, as XMOBUF does not answer any of Compuserves automatic
  77. terminal queries, and will not automatically identify itself to Compuserve.
  78. To download a binary or image file on CompuServe, simply take the download
  79. option as you BROwse a section, and CompuServe will ask which protocol you wish
  80. to use.  Select the XMODEM option, and CompuServe will ask if you wish to use
  81. ASCII or BINARY.  Choose BINARY.  CompuServe will then announce that it is
  82. ready to begin.  Press <F1> to bring up the menu, choose <2> Download, give the
  83. file a name at the prompt and tell it whether it is a <P>rogram or <S>equential
  84. file, and sit back and relax.  Because of packet switching, you may find that
  85. you get more errors during protocol transfers on CompuServe than from your
  86. local BBS.  The best cure for this is tdo come back during off-peak times when
  87. CompuServe is feeling better.
  88.                                   The Buffer
  89. The buffer control menu is available from almost any part of the program by
  90. pressing <F3>.  Loading and saving the buffer is a painfully slow process.
  91. Perhaps some kind soul with a sound knowledge of m/l will rewrite it soon.  The
  92. remaining buffer functions all work well, and a little experimentation should
  93. make them clear.
  94.                                  Source File
  95. The source code for this program has been uploaded to the CBM Programmers SIG
  96. as a .SEQ file to preclude its being inadvertantly taken down by a novice who
  97. might try to run it in interpreted BASIC.  As written, it will not run, becuase
  98. BASIC has insufficient workspace.  In order to make the buffer as large as
  99. possible, memory is repartitioned, and in the compiled version, BASIC is left a
  100. mere 182 bytes of workspace.  With only this much space to play with, garbage
  101. collects occur regularly, but a BLITZ garbage collect seems to take about 3
  102. milliseconds, and is seldom even perceptible.  Those who can take down the .SEQ
  103. file of the source and convert it, and who have access to a compiler, are
  104. welcome to improve it in any way.
  105.                             Questions or Comments
  106. Questions or comments may be directed to
  107.            Chris Kaiser  70036,1604
  108. My preference is for a note on any of the CBM sigs, but I look at Email
  109. sometimes, too.o
  110.            Chris Kaiser  70036,1604
  111. My preferenc